home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / doorstat.zip / DOORSTAT.DOC < prev    next >
Text File  |  1992-01-12  |  9KB  |  212 lines
  1.  
  2. -------------------------------------------------------------------------------
  3.                         Doorstat 5.03 (C) 1989 - 1992
  4.                         Lightning Computer Consultants
  5.                                P.O. Box 1081
  6.                              Yonkers, NY 10702
  7.                Written by Jim Abraham
  8.            Call Lightning Computer Consultants at 914/376-5235
  9. -------------------------------------------------------------------------------
  10.  
  11.  
  12. Thank you for downloading Doorstat and giving it a try.  Doorstat is not free.
  13. It is placed into the shareware market.  You may try this version for 60 days.
  14. After that date, You must register it.  I think that you will agree that it is
  15. worth the small registration fee of $15.00.  I hope you enjoy this program, I
  16. know I enjoyed writing it!
  17.  
  18. *** In the Shareware version your are limited to only the Top 5 Doors and no
  19.     control of the output no matter what the config file says! But you still
  20.     must have that config file there for the program to work!
  21.  
  22. *** Doorstat can be run on any BBS that uses external batch files to load the 
  23. *** door programs. 
  24.  
  25. License Agreement :
  26.  
  27. Doorstat 5.03 is copyrighted by Jim Abraham, Lightning Computer Consultants,
  28. 1989 - 1992
  29.  
  30. The shareware version may be distributed freely.  It must be distributed in its
  31. entirety.  No other files may accompany this package.  If you recieved this
  32. program from a vendor and paid some money for the shareware disk, you are still
  33. obligated to register this program through us.  If you distribute this program
  34. you can not charge any money for it except for the cost of the disk.
  35.  
  36. Lightning Computer Consultants and Jim Abraham assume no responsibility for any
  37. problems caused by this program as is the case with any software.
  38. If you use it, it's your choice!
  39.  
  40. *****************************************************************************
  41. Registration gets you a copy of Doorstat's latest version with your BBS
  42. Name encoded into the program, along with your registration #.  It also
  43. entitles you to free updates of the program via downloading it from Land of
  44. Unicorns BBS at 914-961-0399.  Join the Lightning Computer Consultants
  45. Conference on Land of the Unicorns 1200-38400 Baud 24 Hours a day 7 days.
  46. *****************************************************************************
  47.  
  48. DOORSTAT
  49.                                OK here we go!
  50.  
  51. *** All previous owners of Doorstat MUST READ THIS.  There are a few changes!!!
  52.  
  53.  
  54. *** Doorstat was written with All BBS's in mind.  It was not made specifically
  55.     for one type of BBS
  56.  
  57. Doorstat is a fairly simple program to set up.  Follow these steps and you 
  58. should not have any problems.
  59.  
  60. 1:  Create a file called doorstat.inf.  In this file the first line should be
  61.     the number of doors you are currently running.  Every line after that comes
  62.     the door's name + the door's number in order.  For example for 5 Doors it 
  63.     should look like this.
  64.  
  65. Line 1      5
  66. Line 2      Trade Wars 1000,1
  67. Line 3      Turbo Checkers,2
  68. Line 4      Card Guppies,3
  69. Line 5      King of the Board,4
  70. Line 6      Turbo Checkers,5
  71.  
  72.      The top number should agree with the same amount of file names or the
  73.      program will bomb.  There is a sample of my data file included with this
  74.      program.  This data file should be placed in the same directory your batch
  75.      files are called from. The numbers of the doors are not displayed in the
  76.      output due to any confusion that may be caused due to Door menu programs,
  77.      that could use lettering, numbers, and words.  The numbers after the door
  78.      name are for internal use only and do not state that (for example, 
  79.      Trade Wars 1000, is door #1) It is just a way of Telling Doorstat that
  80.      Trade Wars is listed on section 1 of the program and to add 1 more usage 
  81.      to it, when the paramater is passed!
  82.  
  83. 2:   Make A directory called DOORSTAT and put all the DOORSTAT files in it.
  84.      before you call your door make sure you switch to this directory and
  85.      then run doorstat.
  86.  
  87.      Doorstat excepts paramaters of 3 types
  88.      1] the door number ranging from 1 to infinity
  89.      2] EVENT   which creates the output files
  90.      3] RESET   resets the door values to 0
  91.     *** Make sure you run at least 1 door before running the event
  92.     after you reset the data file!
  93.  
  94.      dooorstat event  creates both an ascii file and ansi file called
  95.      doorstat.asc and doorstat.ans or whatever you want to call it such
  96.      as bullet10.bbs and bullet10.scr.
  97.  
  98. 3:   Modify your batch files to call doorstat beofre the door is loaded.
  99. cd\doorstat            
  100. doorstat 45             Adds door #45 to the data file
  101. cd\door                 go to the door directory
  102. tw1000                  load the door
  103.  
  104. Your Event should look like this
  105. cd\doorstat                                  change to the doorstat directory
  106. doorstat event                               run the doorstat event
  107. cd\bbs                                       change back to the main bbs dir.
  108.  
  109.  
  110. Doorstat.cfg
  111. ------------
  112.  
  113. Doorstat.cfg should have 6 lines in it for example!
  114.  
  115. Y              List all the doors in the listing (Y/N)
  116. 10                        # of doors listed in the top door listing
  117. N                         Play the music doorstat plays (Y/N)
  118. d:\bulletins\bull16.scr   Output file path and name for ANSI bulletin
  119. d:\bulletins\bull16.bbs   Output file path and name for ASCII bulletin
  120. d:\doorstat\doorstat.dat  location and file path name of where the doorstat.dat
  121.                           file is for multinode purposes. (have 1 data file)
  122.  
  123. *** the 1st and 3rd lines are options for registered users only!
  124. *** Whether you put a yes or no does not matter but you have to have either
  125. *** one in their!
  126.  
  127.  
  128. For Previous Owners version 2.4 or earlier!
  129. -------------------------------------------
  130.  
  131. There are not much changes that you have to make!  Check the doorstat.inf file
  132. for the minor change. And make sure you have the Doorstat.cfg file!
  133.  
  134.  
  135.  
  136. That's all there is to it.  Remember, you must modify your door batch files
  137. to call doorstat and pass the number of the door being run as a parameter.
  138.  
  139. These are descriptions of the files that should be included.  If you do not
  140. have these files, call us at Lightning and download doorstat.zip!
  141.  
  142. If you have any problems, before calling us make sure your doorstat.inf file
  143. has the correct # of doors listed at the top left corner and make sure none of
  144. the door names have a " (quote) in the name.
  145.  
  146. DelDoor.exe           Erase Door # from .DAT file (REGISTERED USERS ONLY)
  147. Doorstat.ans          Sample ANSI bulletin!
  148. Doorstat.asc          Sample Ascii bulletin!
  149. Doorstat.dat          Sample data file!
  150. doorstat.inf          Sample Doors name file!
  151. doorstat.exe          Doorstat Main Program!
  152. doorstat.doc          This documentation file!
  153. readme.1st            The registration file!
  154. doorstat.rst          Holds the value of the last reset date!
  155. doorstat.cfg          Doorstat Configuration file
  156.  
  157. DELDOOR.EXE
  158. -----------
  159. This program is only accompanied with full registration.  It should not be
  160. contained with the Unregistered version.  This program should not be
  161. distributed just like the rest of the Doorstat files unless otherwise stated
  162. by myself.
  163.  
  164. This program is used in conjunction with Doorstat.  When you replace and old
  165. door and you want to reset that value without deleting the whole .DAT file or
  166. without having to go into the .DAT file and deleting that door number you
  167. should use this porgram.  It is very simple to use as is Doorstat!
  168. Format 
  169.     Deldoor 45
  170. This will delete any entries of door #45 within the data file.  Pretty simple!
  171. Make sure you are in the same directory as the doorstat.dat file!
  172.  
  173. ****   Don't forget to register your copy Today
  174.  
  175.        Enjoy this program.  I know I do!
  176.  
  177.  
  178. HISTORY OF DOORSTAT
  179. -------------------
  180. 1.0  First release
  181.  
  182. 2.0  Added top five doors listing!
  183.      Added percentages
  184.  
  185. 2.3  Brun45.exe is no longer needed to run this program
  186.      straightened out display a little
  187.  
  188. 2.4  Changed TOP 5 Doors to TOP 10 Doors
  189.      Also made some more cosmetic changes!
  190.  
  191. 3.0 Burned in the fire (pun)
  192.  
  193. 4.0 My Dog ate it!
  194.  
  195. 5.0 Changed Output completely, User configurable top door listing, User
  196.     configurable choice of displaying all the doors along with the top doors
  197.     or just the top doors.  Does not have a 100 Door limit anymore.  Program 
  198.     is not case sensitive anymore. (REGISTERED USERS ONLY) have the option of
  199.     The # of Top Doors, UNREGISTERED users are limited to the top 5 doors.
  200.     REGISTERED USERS have the option of whether or not to list the entire 
  201.     listing or not!
  202.  
  203. 5.01 Added the option to have Doorstat's sound turned off through the 
  204.      doorstat.cfg file (REGISTERED USERS ONLY)
  205.  
  206. 5.02 Added selection for filename and file path for output screens.
  207.      Speeded up processing time during non event execution.
  208.      Added selection for data path name and location for multi node use!
  209.  
  210. 5.03 Fixed the problem with the RESET Option!  Also added a check for a 
  211.      0 entry in the data file!
  212.